home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / tools / sayinva.com / SINVALID.DOC < prev   
Encoding:
Text File  |  1980-10-13  |  13.3 KB  |  261 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                  Say Invalid
  7.  
  8.            When you run SINVALID.COM ("Say Invalid"), it says the 
  9.        words "Attention! Invalid input. Please Redo." through the 
  10.        computer speaker. No extra hardware is required. You can run 
  11.        this program from DOS, if you like. It is more useful, 
  12.        however, to run this program from within your own program by 
  13.        issuing a DOS CALL or SHELL. For example, in BASIC, you would 
  14.        include the command SHELL "SINVALID" anywhere you wanted the 
  15.        program to give this error message verbally. This is useful 
  16.        when you have a program that accepts input from the user, if 
  17.        some inputs could crash the program. Until now, most programs 
  18.        simply BEEPed the speaker and displayed a message on the 
  19.        screen. SINVALID.COM gives your program a more professional 
  20.        touch, and is somewhat less annoying to most people than the 
  21.        harsh BEEP.
  22.            SINVALID.COM also displays a window in the center of the 
  23.        screen containing the words "Attention! Invalid input. Please 
  24.        redo." while the computer is speaking. The window will 
  25.        disappear after the computer stops speaking, and the original 
  26.        screen under the window will be restored. If you do not want 
  27.        SINVALID.COM to display this window, include a slash (/) 
  28.        followed by NW in your command line that calls SINVALID.COM. 
  29.        For example, from BASIC you would use the command
  30.        SHELL "SINVALID /NW" to prevent SINVALID.COM from displaying 
  31.        the window. The NW must be capitalized, and must immediately 
  32.        follow the slash (no spaces).
  33.            If you tell SINVALID.COM not to display the window, I 
  34.        recommend that you have your program display a message on the 
  35.        screen, in case the computer speaker is broken or has been 
  36.        disabled in some way. The clarity of the spoken message will 
  37.        also vary somewhat with the quality of the computer's speaker, 
  38.        so a visual message is helpful to make sure the user 
  39.        understands the message.
  40.            In order for your program to execute the SHELL "SINVALID" 
  41.        command, the program SINVALID.COM must be in the current path 
  42.        so your program can find it. For most compilers, the 
  43.        COMMAND.COM program must also be available for the SHELL 
  44.        command to work. That is, you cannot have removed your boot 
  45.        disk containing COMMAND.COM from the computer.
  46.            After SINVALID.COM is run, it displays a shareware notice 
  47.        on your screen telling you how to register. When you register, 
  48.        you will receive instructions on how to run SINVALID.COM 
  49.        without displaying this message.
  50.            MRSINV.COM is a memory resident version of SINVALID.COM. 
  51.        When you run this program, it installs itself in memory and 
  52.        attaches itself to interrupt 241 (F1H). This is an interrupt 
  53.        that is not currently being used by any commercial hardware or 
  54.        software that I know of.
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.            Once you have installed this program, you can cause the 
  62.        computer to say the error message at any time by calling 
  63.        interrupt 241. This is handy for assembly language programs, 
  64.        since they can easily call interrupts. However, almost all 
  65.        compilers now have some way of calling interrupts, so you can 
  66.        use this program with most languages. Using the memory 
  67.        resident version has the advantage that your program does not 
  68.        have to access the disk once the program is resident. It also 
  69.        no longer needs to have access to SINVALID.COM or COMMAND.COM 
  70.        to give the error message.
  71.            If you write your program so that it makes a call to 
  72.        interrupt 241, your must be very careful to make sure that 
  73.        MRSINV.COM has been installed before your program is run. 
  74.        Trying to call interrupt 241 without MRSINV.COM installed can 
  75.        send your computer off to never-never land, forcing you to 
  76.        reboot. The best way to be safe is to create a batch file that 
  77.        first loads MRSINV.COM, then runs your program. You can then 
  78.        give your program file an odd, hard-to-remember name like 
  79.        KWVDJZP.EXE and the batch file an easy name to type and 
  80.        remember, to encourage people to use the batch file instead of 
  81.        running the program directly.
  82.            This program also normally displays a window with the 
  83.        error message in it while it is speaking. To avoid this, 
  84.        include the /NW switch on the command line when you install 
  85.        MRSINV. That is, you would type MRSINV /NW at the DOS prompt 
  86.        to install the program.
  87.            If interrupt 241 is not a good interrupt for you to use 
  88.        for some reason (like someone comes out with a new piece of 
  89.        hardware that uses it), you can change the interrupt that 
  90.        MRSINV.COM uses. Interrupts 97 through 102 (61H thorough 66H) 
  91.        and 241 through 247 (F1H through F7H) are good interrupts to 
  92.        use. Just put the new interrupt number on the command line 
  93.        after MRSINV. For example, to have the program use interrupt 
  94.        242, type MRSINV 242 at the DOS prompt to install MRSINV.COM. 
  95.        The number of the new interrupt must be the first thing after 
  96.        the space after MRSINV. If you use the /NW switch, it must 
  97.        come after the interrupt number, such as MRSINV 242 /NW. The 
  98.        number MUST be expressed as a decimal number, not a hex number.
  99.            You can uninstall MRSINV.COM by typing MRSINV /U at the 
  100.        DOS prompt (Note: Capital U required). There are a few
  101.        restrictions. If you have installed any TSR (memory resident)
  102.        programs after MRSINV.COM, these must be uninstalled first. In
  103.        general, you must always uninstall TSR programs in the reverse
  104.        order that you installed them. If anything should go wrong with
  105.        the uninstalling process, the program will display an error
  106.        message and suggest that you reboot your system. This is a
  107.        very unusual occurrence.
  108.            This program also displays the shareware notice when it 
  109.        speaks the message. The instructions for avoiding this notice 
  110.        that you get when you register SINVALID.COM also apply to this 
  111.        program.
  112.  
  113.  
  114.  
  115.  
  116.  
  117.        Registration
  118.        
  119.            To register SINVALID.COM, send $5 to:
  120.        
  121.                                 Leithauser Research
  122.                                 4649 Van Kleeck Drive
  123.                                 New Smyrna Beach, FL 32169
  124.        
  125.        Include your address so I can send you the necessary 
  126.        information on how to run the programs without displaying the 
  127.        shareware notice.
  128.        
  129.        Other voice routines
  130.        
  131.            Leithauser Research will prepare voice routines saying 
  132.        anything you want (except for profanity, racial or ethnic 
  133.        slurs, or otherwise offensive material). The charge is $10  
  134.        for the first phrase and $5 for each additional phrase ordered 
  135.        at the same time. A phrase is a group of words that are spoken 
  136.        at one time. For example, you might want your program to say 
  137.        "Invalid input. Please Redo." if the user inputs unacceptable 
  138.        input and "File not found. Try another file name." if the user 
  139.        tried to load a file that does not exist. In this case, 
  140.        "Invalid input. Please redo." would be one phrase and "File 
  141.        not found. Try another file name." would be another phrase. 
  142.        Although phrases can be fairly long, there are some limits. 
  143.        Don't try to put your entire operating manual into one phrase.
  144.            The voice routines can be prepared in one of four ways:
  145.        
  146.        1) You can have individual programs, each of which contains 
  147.        one phrase. SINVALID.COM is an example of such a program.
  148.        
  149.        2) You can have one program that generates several phrases, 
  150.        controlled by a command line switch. For example, if the 
  151.        program is called PHRASE.COM, you could have it say one phrase 
  152.        by using the command SHELL "PHRASE /1" and another phrase by 
  153.        using the command SHELL "PHRASE /2". For technical reasons, 
  154.        there is a limit of eight phrases per program.
  155.        
  156.        3) The programs can be designed to become memory resident, 
  157.        like MRSINV.COM. A memory resident program can contain up to 
  158.        eight phrases. You can select which phrase you want the 
  159.        program to speak by setting the value of AX. If the program 
  160.        has only one phrase, the value of AX has no effect.
  161.        
  162.        4) For QuickBASIC programmers, I can build the voice modules 
  163.        directly into your compiled program. When I do this, you do 
  164.        not need to SHELL out of the program or load memory resident 
  165.        programs. This eliminates the need to distribute separate 
  166.  
  167.  
  168.  
  169.  
  170.  
  171.        files with your program. It also eliminates the problems 
  172.        associated with the use of the SHELL command, such as the 
  173.        need to have COMMAND.COM available. To have voice modules 
  174.        installed in your QuickBASIC program, send the following to 
  175.        Leithauser Research:
  176.        A) A list of the phrases you want installed in your program.
  177.        B) The name you want to give the subprogram within your 
  178.        program that speaks a particular phrase. You must give a 
  179.        different subroutine name to each phrase you want the program 
  180.        to speak.
  181.        C) The source code for your program, saved in the ASCII 
  182.        format. Include the statement CALL SubroutineName each place 
  183.        in your program that you want it to speak a certain phrase, 
  184.        where SubroutineName is the name of the subroutine for a 
  185.        particular phrase. For example, if you told me you wanted the 
  186.        program to say "File not found" and that the subroutine for 
  187.        this phrase should be named FileNotFound, then you would put 
  188.        CALL FileNotFound anywhere in the program that you want the 
  189.        program to say this phrase.
  190.        D) $10 for the first phrase and an additional $5 for each 
  191.        additional phrase. A phrase is defined as a collection of 
  192.        words that are spoken by one subroutine.
  193.        I will then create the voice routines, link them with your 
  194.        program, and send you back the compiled program. I must do the 
  195.        compiling myself. Source code for the voice routines is not 
  196.        available.
  197.        
  198.        Other custom programming
  199.        
  200.            In addition to "voicifying" (??) programs, Leithauser 
  201.        Research also has a complete custom programming service. If 
  202.        you need an unusual program that you cannot write yourself or 
  203.        find commercially, write for information to:
  204.        
  205.                                 Leithauser Research
  206.                                 4649 Van Kleeck Drive
  207.                                 New Smyrna Beach, FL 32169
  208.        
  209.            For a price quote, include a description of the program 
  210.        you want written. Once you have purchased a custom program, 
  211.        you are free to distribute it any way you like.
  212.  
  213.  
  214.  
  215.          ----------------end-of-author's-documentation---------------
  216.  
  217.                          Software Library Information:
  218.  
  219.                     This disk copy provided as a service of
  220.  
  221.                            Public (software) Library
  222.  
  223.          We are not the authors of this program, nor are we associated
  224.          with the author in any way other than as a distributor of the
  225.          program in accordance with the author's terms of distribution.
  226.  
  227.          Please direct shareware payments and specific questions about
  228.          this program to the author of the program, whose name appears
  229.          elsewhere in  this documentation. If you have trouble getting
  230.          in touch with the author,  we will do whatever we can to help
  231.          you with your questions. All programs have been tested and do
  232.          run.  To report problems,  please use the form that is in the
  233.          file PROBLEM.DOC on many of our disks or in other written for-
  234.          mat with screen printouts, if possible.  PsL cannot debug pro-
  235.          programs over the telephone, though we can answer questions.
  236.  
  237.          Disks in the PsL are updated  monthly,  so if you did not get
  238.          this disk directly from the PsL, you should be aware that the
  239.          files in this set may no longer be the current versions. Also,
  240.          if you got this disk from another vendor and are having prob-
  241.          lems,  be aware that  some files may have become corrupted or
  242.          lost by that vendor. Get a current, working disk from PsL.
  243.  
  244.          For a copy of the latest monthly software library newsletter
  245.          and a list of the 2,000+ disks in the library, call or write
  246.  
  247.                            Public (software) Library
  248.                                P.O.Box 35705 - F
  249.                             Houston, TX 77235-5705
  250.  
  251.                                 1-800-2424-PSL
  252.                                  MC/Visa/AmEx
  253.  
  254.                           Outside of U.S. or in Texas
  255.                           or for general information,
  256.                               Call 1-713-524-6394
  257.  
  258.                           PsL also has an outstanding
  259.                           catalog for the Macintosh.
  260.  
  261.